<!DOCTYPE html>
 
<html>
<head>
  <title>Container Clips</title>
  <link rel="stylesheet" href="style.css">
<script src="toc.js" type="text/javascript"></script>
</head>

<body>

<div id="content">
<img src="header_text_5.png">

<script src="tocgen.js"></script>

<div id="toccontent">

<div class="subject-header">Container Clips</div>



<div id="toc"></div>

<h2>Container Clips Concept</h2>
<p>
A <b>Container Clip</b> is a Media Item and the Timeline Clip made from it that has three items packed together as a single entity: <i>Program, Unrendered Media</i> and <i>Rendered Media</i>.
</p>
<h3>Components</h3>
<ol>
<li><b>Unrendered Media</b> This is what is displayed on timeline if container clip media is not rendered.</li>
<li><b>Program</b> This data is used to render a media clip on timeline, sometimes using unrendered media as input.</li>
<li><b>Rendered Media</b> This is what is displayed on timeline when Container Clip is rendered.</li>
</ol>

<h2>Selection Container Clips</h2>
<h5>Components</h5>
<p>
<ul style="list-style-type:none">
<li><b>Unrendered Media</b> A MLT XML vdieo clip created from selection or sequence like Compound clips previously.</li>
<li><b>Program</b> A MLT XML video clip created from selection or sequence like Compound clips previously. Here Program is the same as unrendered media.</li>
<li><b>Rendered Media</b> Clip Rendered from MLT XML Clip.</li>
</ul>
</p>
<h5>Use Cases</h5>

<ul>
<li>Make possible to create Media items from selections and full Sequences.</li>
<li>Give better timeline performance for complex multitrack container clips by pre-rendering them on timeline.</li>
</ul>

<h5> Creating Selection Container Clip from Selection</h5>

<ol>
<li> Select 2 or more adjacent clips from a single track.</li>
<li> Select <b>Project->Create Container Clip->From Selected Clips</b></li>
<li> A new Media Item appears in the current Bin.</li>
</ol>

<h5> Creating Selection Container Clip from Box Selection</h5>

<ol>
<li> Select an area on Timeline by dragging a box selection with <b>Left Mouse</b> around all items you wish to be part of the <b>Compound Clip</b>.</li>
<li> Select <b>Project->Create Container Clip->From Selected Box Selection</b></li>
<li> A new Media Item appears in the current Bin.</li>
</ol>

<h5> Creating Container Clip from Timeline Range</h5>

<ol>
<li> Select a range on Timeline by setting <b>Mark In</b> and <b>Mark Out</b> points.</li>
<li> Select <b>Project->Create Container Clip->From Timeline Range</b></li>
<li> A new Media Item appears in the current Bin. It will contain all full and partial Clips in the given range.</li>
</ol>

<h5> Creating Selection Container Clip from Sequence</h5>

<ol>
<li> Select <b>Project->Create Container Clip->From Current Sequence</b></li>
<li> A new Media Item appears in the current Bin.</li>
</ol>

<h5> Creating audio synced Selection Container Clip from two Media Items</h5>

<ol>
<li> Select 2 Media Items in Media panel.</b>
	<ul>
	<li> The expected case is to select <b>1 Video and 1 Audio Clip</b>.</li>
	<li> If you select <b>2 Video Clips</b> then which is used as video depends on selection order.</li>
	<li> Audio from clip treated as video is muted.</li>
	</ul>
</li>
<li> Select <b>Project->Create Compound Clip->Audio Sync Merge Clip From 2 Media Items</b></li>
<li> If audio sync is successful a dialog appears. Give a name for the new Media Item in the dialog.</li>
<li> A new Media Item appears in the current Bin.</li>
</ol>

<div class="note">
Audio syncing looks for best mathemathical match between two audio waveforms, so <b>audio syncing non-matching audio will produce random results.</b>
</div>

<h2>Generator Container Clips</h2>
<p>
<b>Generators</b> are Container Clips too, see more info in chapter <a href="generatorsfluxity.html">Generators and Fluxity API</a>
</p>

<h2>Sequence Link Container Clips</h2>

<p>
<ul style="list-style-type:none">
<li><b>Unrendered Media</b> A MLT XML video clip created or recreated from Contents of a Sequence on request</li>
<li><b>Program</b>  Contents of a Sequence.</li>
<li><b>Rendered Media</b> Clip Rendered from MLT XML Clip.</li>
</ul>
</p>

<h5>Use Cases</h5>
<ul>
<li>Provide a convenient way to use Sequences as parts of a master Sequence.</li>
</ul>

<h5> Creating Sequence Link Container Clips</h5>
<ul>
<li>Select from menu <b>Project->Add Sequence Link Container Clip</b> to create a <b>Sequence Link Container Clip</b> media item.</li>
<li>Drag <b>Sequence Link Container Clip</b> Media Item on Timeline to create a clip.</li>
<li><b>Sequence Link Container Clips</b> can't be placed on Sequences they link to and creating cyclic dependencies between sequencse using <b>Sequence Link Container Clips</b> is not allowed.</li>
</ul>
<h5> Updating Sequence Link Container Clips</h5>
<ul>
<li>Click <b>Right Mouse</b> on clip and select <b>Update Sequence Link Clip</b> to update clip to display current contents of Sequence it is linked to.</li>
</ul>
<h5> Replacing Sequence Link Container Clip with Sequence Contents</h5>
<ul>
<li>Place Playhead at the beginning of <b>Sequence Link Container Clip</b>.</li>
<li>Select from menu <b>Sequence->Import Another Sequence Into This Sequence...</b> and select option <b>Insert Sequence at Playhead position</b> and do import.</li>
<li>Delete <b>Sequence Link Container Clip</b>.</li>
</ul>

<h2>G'Mic Script Container Clips</h2>

<h5>Components</h5>
<p>
<ul style="list-style-type:none">
<li><b>Unrendered Media</b> Video Clip.</li>
<li><b>Program</b> G'Mic script created and saved from G'Mic tool.</li>
<li><b>Rendered Media</b> A clip rendered with G'mic effect.</li>
</ul>
</p>
<p>
<h5>Use Cases</h5>
<ul>
<li>Render G'Mic effects only on clip ranges used on timeline.</li>
<li>Make easier to use single user defined G'Mic effect on multiple clips.</li>
</ul>

<h5> Creating G'Mic Script Container Clips</h5>

<ol>
<li>Open <b>G'Mic tool</b>.</li>
<li>Create G'Mic effect script. See section on <b>G'Mic Effects</b> in Chapter <b>Tools</b>.</li>
<li>Press <b>Save Script</b> button in bottom left corner and save effect.</li>
<li>Select menu item <b>Project -> Create Container Clip -> From G'Mic Script</b>.</li>
<li>Select the script you saved and the clip that it will be applied on to create Container Clip.</li>
</ol>

<h2>Rendering Container Clips</h2>
<h4>Container Clip Render Actions</h4>
<p> Render actions are available from Clip <b>Right Mouse</b> context menu in <b>Generator and Container Rendering</b> submenu.
<ul>
<li><b>Render Clip...</b> Renders Clip and stops using <b>Unrendered Media</b> on timeline.</li>
<li><b>Render Settings...</b> Allows setting how and where a clip is rendered.</li>
<li><b>Switch to Unrendered Media</b> Switch to using <b>Unrendered Media</b> and drops the current <b>Rendered Media</b> version of <b>Program</b>.</li>
<li><b>Set Default Encoding...</b> Allows setting encoding format that is used for all <b>Container Clips</b> and <b>Generator</b> as default video encoding.</li>
</ul>

</div>

</div>
</div>

</body>

</html> 
